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1.0 Overview 



The PhoenixPhlash flash utility will be used to program BIOS images into flash ROMs in 
AT compatible systems. The utility will consist of the following files: 

PHLASHNT.EXE - used to program the flash ROM 
PLATFORM.DLL - used to perform platform dependent functions 
BIOS.ROM - actual BIOS image to be programmed into flash ROM 

wSf aSR^Sw P r0vides o » det *l«i description of the functionality for the 
PHLASHNT.EXE program. Because PLATTORM.DLL and BIOS.ROM are platfonn 
specific, only the general format of these two files is covered in this document 

PhoenixPhlash will be executed as a Win32 console application. 

High priority is being placed on flexibility, adaptability and supportability for this desien 
KT-Sjr^L Kt U ? h capability as possible wffi be placed into the 

PLATFORM.DLL file so that many different platforms and configWUow can t* 
supported wthout modifying PHLASHNT.EXE. PhoenixPhlash will support plasms 

ROM** ^m£, ? °%aF?- UWeUaS *S™ mul tiple AashROMs. Flash 
ROMs from 1 Mbit to 4Mbits or greater will be accommodated; including boot block 
devices and devices with any configuration of multiple flashable regions. 

For each supported part, all code specific to the particular flash ROM part (e.g. Intel 
28Fxxxx) will be part of the PHLASHNT.EXE module. All code and parameters specific 

m a?SXw fcf flas J h , eMb,e flash R0M ^d"" range) will be part of the 

PLATFORM.DLL module. r 

PHLASHNT.EXE, the main module of the PhoenixPhlash utility, will contain all code 
which is platform independent It will contain user interface code, code to load and 
verify the PLATFORMDLL file and the platform independent portions of code to 
program a flash device. 

PHLASHNT.EXE will be a Win32 executable file, generated using Microsoft C++ V4.2 
or later. 



Using CDrivar to access hardware 

PHLASHNT.EXE uses the CDriver C++ class which works in conjunction with the 
PhoenixAD driver to enable Windows NT user-mode applications to access I/O ports; to 
access BIOS data and code area; and to execute BIOS32 services. The CDriver class 
provides a simple and flexible interface between the application program and the 
PhoenixAD driver. 

CDriver works in conjunction with the PhoenixAD driver to provide the following 
functions to user-mode application programs. 

Access to I/O ports 

Execute 310S32 services 
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Access the BIOS image 

Access BIOS data areas 

Read the system Real Time Clock 
The CDriver class serves as a thin wrapper interface between Windows NT applications 
and the PhoenixAd driver. It encapsulates the interface to the driver and provides 
flexibility to both applications and the kernel driver designs. 

To assure future compatibility, PHLASHNT.EXE does not call the PhoenixAD driver 
directly; instead, it calls the methods in the CDriver class. 
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2.0 Modes of Operation 



2.1 Win32 Console 

PHLASHNT.EXE will be started in a Windows NT window, followed by oouonal 
command line flags (if any). ' Y 

Command line flags will include (both lower and upper case characters are acceptable): 

/A 

AUTODETECT OFF • Do not read ID from the part. By default, program 
verifies that the manufacturer ID and part ID read from the part, matches the 
ID specified in the PLATFORMJDLL file and when the two IDs difTer, the ID 
read from the part is used. This allows one to use the same PLATFORM.DLL 
and BIOS.ROM for several different parts without the need to modify either 
of the two files. When this flag is not set, then it is assumed that the ID is 
"readable" from the part When this flag is set, the ID from the part is not 
used, instead the values specified in the PLATFORM.DLL are used. 

/B m filename 

BINARY FILE - Overrides the default platform specific binary file. This 
option is required when a full path specification is needed and/or the binary 
file has a name other than PLATFORMDLL. 

fb\}~ftlename 

BACKUP - Save the previous version of the BIOS image into file filename 
before erasing. Filename is optional; if not specified, the previous image is 
stored in BIOS.BAK. Because many versions of BIOS use platform 
dependent features such as shadow memory and de-compression, it is often 
necessary to use platform dependent code in PLATFORM.DLL to retrieve the 
BIOS image before it can written to a file. 

/C 

CMOS UPDATE - Clears the CMOS checksum after Flash is updated. If the 
AUTO_UPDATE feature is installed in the new BIOS image, the BIOS 
automatically sets all CMOS fields to their default values on the next boot If 
the AUTO.UPDATE feature is not loaded, the BIOS displays the CMOS 
checksum error message on the next boot and prompts the user to press the F2 
key to execute Setup and manually reconfigure the machine. 

/CS 

CHECKSUM BIOS ROM • Computes checksum on BIOS ROM image. If 
the checksum is not zero, or if the optional PLATFORM.DLL function 
CheckSum fails, the program terminates with an error message. 



USAGE - Display program name, version, copyright and help screen. /? can 
also be used for this option. 



T^l^^VZ^ •* *** R0M fi " *• - 

/MODE-n 

OPERATION • Selects the operating mode for PHLASHNT tv. r n n~ ■ 
operating modes are currently wpponed: rHLAI >"NT- The following 

0 me BI0S ""ge (*c normal operatinc mode^ in tk;« 

PHLASHNT replaces the cWent BIOS W^L M 
DMI information in the system BIOS is maintained ThiTbS'drflJS 

2 Update both the BIOS and DMI information (save system DMI string 

PHLASHNT both replaces the' current B?cSta5?1S 
wntes the strings specified via the DMI command line flags to Flash The 
DMI information in the system BIOS is maintained unless new DMI 
strings are specified on the command line. 

3 Update both the BIOS and DMI information (reset system DMI strin2s} 
In this mode, PHLASHNT both replaces the current BIOS imJge ?nd 
wntes the strings specified via the DMI command line flags to Flash The 
DMI information in the system BIOS is replaced with the DMI strines 
from the new BIOS ROM image and/or ncwDMl strings specified on the 



/N 



to 



/P 



command line. 

These options are not displayed by the help (/H) option for security reasons. 

NEW (different) - Proceed only for different version of BIOS ROM If the 
data structure at BCPSYS. which includes BIOS version and build date I 
time, is same as the corresponding structure in the BIOS.ROM file then the 
programs terminates without flashing. 

gVEWUDE PLATFORM.DLL OPTIONS - Disable all flags set in 
PLATFORM.DLL. Without this switch, options set in the PLATFORM DLL 
are combined with options specified on the command line. When this switch is 
used, only command line options are used. 

PRODUCTION - Maximize speed of flashing. All user feedback is reduced 
to a minimum (no sound, or screen update). This is used to reduce the time 
needed to flash, a part in a production environment. Only the final 
success/failure is reported. 
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/PN 

BIOS PART NUMBER CHECK - Proceed only if the BIOS part number in 
BIOS. ROM is the same as the part number in the current BIOS. 

/PF="list of options" 

Command line options to be passed to the platform dependent module 
PLATFORM.DLL. On some platforms it may be desirable to pass command 
line options to the platform dependent procedures. This is done via the 
CmdLineO function. When both the CmdLineO address is non-zero and this 
command line option is present, then the string immediately following the 
equal sign will be passed to PLATFORMJDLL (enclose the string in double 
quotes if the string includes spaces). 

/Rn 

RETRY - If flashing a block fails, retry n times instead of aborting. 

The /Rn option can be used in crisis mode by setting psiRetryCount with the 

desired retry count in PLATFORM.CPP. 

/S 

SILENT - Silent operation without audio feedback. 

N 

VERIFY • After each block is programmed, data in the flash part address 
space will be compared to the data in the BIOSJROM file. Any discrepancies 
are reported and the program will either re-try programming of the same block 
or the system will hall (depending on the response to a prompt). Because the 
check is made aAer the flash memory was erased, the system will be very 
unstable and it may not be possible to properly notify the user and recover. 

IZ 

ZERO BLOCKS - Zero flash blocks before erasing. 



filename 

BIOS ROM image file name. Any command line option without the leading 
back-slash will be interpreted as the file name for the BIOS ROM image file. 
A filename is only required when necessary to specify a full path for the ROM 
BIOS image and/or the ROM BIOS image file is different than BIOS .ROM. 

©filename 

Response file. Any of the command line options described above may be 
placed in a response file. PHLASHNT will read the file and process the 
options as though they were entered on the command line. The options may 
be placed on a single line or on separate lines. Each line may be up to 1024 
characters in length. 

The following command line flags are used to write information to Flash for later 
retrieval through the Phoenix Desktop Management Interface (DM1). DMI command line 
flags are ignored if the target BIOS image does not support the DMI interface (doesn't 
have a DMI BCP structure installed) or the PHLASHNT operation mode is BIOS only 
... (see above). 
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All flags hive the format /DxxStrmg, where xc is one or tw* rK«r«rt~* u—c • L 
.peeific DMI «rin g (see Wow). D& SSSaSSSM^- W?S± 

string butter wen t modified, unless a default strino is «n-Hfi*H in pt atcAdw i?, 8 . . 
*h ««, PHLASHNT .tarn ^^SSW^J^SSS^Sb^ 



length of each DMI string is platform snecific- T>HT^«5xrr P .!f -5 maxirnum 
string i, longer thanAe* co^^^ 

sssr m **° a «- Thcsc ° pti °- « »« *v$ e b y £ he^ 



/DbH ^Siring 


Specifies 


fuMS'String 


Specifies 


/uFSiString 


Specifies 


/DVSString 


Specifies 


/DSMString 


Specifies 


/DMMString 


Specifies 


/D?MString 


Specifies 


/DVMString 


Specifies 


/DSCString 


Specifies 


/DMCSiring 


Specifies 


/D?CString 


Specifies 


/DVCString 


Specifies 


/DOl'String 


Specifies 


fDOnStrlng 


••• 

Specifies 



The system and chassis switches arc available only with DMI version 2.0. 

The older forms of the command line switches, given below, were originally for DMI 12 
and are kept for compatibility. These are equivalent to /DSM, /DMM, /DPM and /DVM 
respectively. 

/DS String Specifies the motherboard serial number string. 
fDUString Specifies the motherboard manufacturer's name string. 
fD?String Specifies the motherboard product (model) identification string. 
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/DV String Specifies the motherboard version suing. 

5!f Xt, ,/ he . a^ 11 .P ro C ,m "i" load the PLATFORM.DLL file and" call «h» «i.if««, 
dependent function EnableFlashO in platfod u nn 10(1 , ^e platform 

For each block of the flash ROM to be programmed: 

1) BcginFlashO is called in PLATFORM.DLL 

l\ P^ITO Algorithm in PHLASHNTXXE is executed 
3) EndF lashO »s called in PLATFORM J3LL. 

This process is repeated for each flash block specified in PLATFORM nt t tu- u 

saving and restoring of memory regionTsS a^ot blacks l ™ aUl ° matlC 

During flashing, progress information is presented to the user. 

i?^ J£ Production mode is not selected, an appropriate messaee window will be 
d»splayed on the screen, which will include t£ne if day, gas nZ^^mrel 
indicator and status line message. 8 8 * progress 

2) Approximately once every second a short beep is sounded. 

debulVSn. ^ ^ e0B * ,elto,l of «* ■» appropriate code is sent to the 

Video will be updated at least once every second. The sound will be senerated 
gp~ely every second. Note that in production cnv^nm^ro^ JdffS! oe 

After flashing is complete, DisableFlashO is executed from the PLATFORM DLL file 

5S^^^2S£5f appropnate message Wfatow ^ 66 ^ Afl " * 

2.3 Completion Codes 

te t |S^«S^^ ««P* «nd will be capable of reporting 

&toXi£S& Thten^s^S?: 0 ' Vt idCntified by $0uSS Wd 

0 Read and verify PLATFORM.DLL file 

2) Perform platform specific initialization 

3) Program the pan 
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If the program fails to complete my of the three major stages of the flashing process, 
program will use distinct sound sequence and keyboard LEDs to inform user at which 
Klf™? P t ro i ram ffliled - At toe ^ of program CAPS LOCK, NUM LOCK and 
SCROLL_LOCK LEDs on the keyboard will be turned on. "The failure at~each of the 
three stages is indicated as follows: 

Sound Keyboard Description 

LEDs ON 

low buzz + 3 short tones CAPS, NUM, SCROLL 1. Before reading platform.dll 
ow buzz + 2 short tones CAPS, NUM 2. Before platform init 

low buzz +1 abort tone NUM 3. After platform init 

Hong tone none Successful completion 

? x *& }^!^K3^ cA t** 0 * locatin * PLATFORM.DLL. Most likely due to errors 
in PLATFORM .DLL file format System is in stable mode, no changes have been made 
to the BIOS, no re-boot is needed. 

Stage 2 • Failure during platform dependent initialization. System is unstable and re-boot 
is needed. No changes have been made to the BIOS. 

Stage 3 - Failure during programming of the flash memory. System is unstable and the 
BIOS flash memory is corrupted System must be restarted with Crisis Diskette. 

The program will also perform error detection at each of the steps. Unless explicitly 
disabled by the PRODUCTION option, as the program progresses it will report on the 
screen and debug port either the step number of the step currently in progress, or one of 
the error codes. Code numbers for errors and program steps are further defined in 
Appendix B2: 

When an error is detected before any changes are made to the flash memory part, then 
program will attempt to notify the user and then will exit PHLASHNT with proper error 
messages. Once the flash memory has been modified, errors will cause the program to 
halt. 

2.4 Device Dependent Modules 

For each type of flash memory supported, there will be a part specific module to perform 
the following: 

1 ) Identify the part and return the manufacturer ID and the part ID 

2) Zero a range of flash memory (set all bits to 0) 

3) Erase a range of flash memory (set all bits to 1 ) 

4) Program a range of flash memory 
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2.4.1 Autodetectlon 

In this module will be the code necessary to read the Manufacturer ID and part ID from 
the flash memory part If IDs cannot be determined, zero is returned. The built-in auto- 
detect module will not be used when the AutoSenseQ function is provided in the 
PLATFORMJDLL file; the provided AuioSenseO function wUl be used instead. 

2.4.2 ZAro 

There are several part types which require thai the flash memory is set to zero before it 
can be programmed. In this module will be the code necessary to set memory ranae to 
zeros. 6 



2.4.3 Erase 

Most flash memory parts require that the flash memory is set to all ones before the part 
can be programmed. These parts often Allow erasure of a full block of flash memory 
with a single write operation. In this module will be the code necessary to set memory 
range to ones. 

When block descriptors are defined in the PLATFORMDLL file, descriptors must be set 
up so that there is At least one descriptor for each "erasable" block in the flash memory. 
For example in Intel 28F004 flash memory there is one 16kByte BOOT block, two 
SkByte PARAMETER blocks, one 96kfiyte MAIN block and three 128kByte 
EXTENDED blocks. Each of the seven blocks can be erased with a single write and 
there must be at least one descriptor for each of the seven blocks. 

2.4.4 Program 

In this module will be the code necessary to read the data bytes form the BIOS ROM 
image and program these into the flash part. 

2.5 Supported Devices 

Initial set of flash memory devices supported by PHLASHNT.EXE will include the parts 
listed in the table below. For each part type a manufacturer and part ID and part 
description is listed. As new parts become available it may be necessary to add additional 
modules to PHLASHNT.EXE so that a new type of flashing algorithm is provided ( new 
AutoDeteetO, ZeroQ, EnseO and ProgramO functions). If it is possible for the new part 
to use one of the existing algorithms and only the Manufacturer or Part ID changes, men 
this can be indicated in the PLATFORM.DLL file and no modification of 
PHLASHNT.EXE is needed (see section on PartTypes for more detail). 



Type 


MfgID 


Part ID 


Description 


2 


0x01 


OxAl 


AMD 28F2S6 


2 


0x01 


0x25 


AMD28F512 


1 


0x01 


0xA7 


AMD 28F010 


1 


0x01 


0xA2 


AMD 28F010A 


2 


0x01 • 


0x2A 


AMD28F020 
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2 


0x01 


0x29 


2 


0x01 


0x20 


2 


0x01 


0xA4 


2 


0x01 


0x51 


10 


0x01 


OxBO 


10 


0x01 


0x34 


10 


0x01 


OxDC 


10 


0x01 


Ox5D 


3 


OxlF 


OxDS 


8 


0x1 F 


OxDA 


3 


OxlF 


0x35 


1 


OxlC 


OxDO 


1 


0x89 


0xB9 


1 


0x89 


0xB8 


1 


0x89 


0xB4 


1 


0x89 


OxBD 


4 


0x89 


0x94 


4 


0x89 


0x95 


4 


0x89 


0x7C 


4 


0x89 


0x7D 


4 


0x89 


0x74 


4 


0x89 


0x75 


4 


0x89 


0x78 


4 


0x89 


0x79 


4 


0x89 


0x70 


4 


0x89 


0x71 


5 


OxBF 


0x07 


12 


OxBF 


OxlO 


5 


OxBF 


0x5D 


6 


OxBF 


0x04 


1 


0x20 


0x07 


7 


0xC2 


0x11 


11 


0xC2 


0x2A 



AMD28F020A 
AMD29F010 ... 
AMD 29F040 
AMD29F200T 
AMD 29F002T 
AMD29F002B 
AMD 29F002BXT 
AMD 29F002BXB 
ATMEL29C010 
ATMEL 29C020 
ATMEL29LV010 
Mitsubishi 28F101 
Intel 28F256 
Intel 28F512 
Intel 28F010 
Intel 28F020 
Intel 28F001 BX-T 
Intel 28F001 BX-B 
Intel 28F002 BX-T 
Intel 28FO02 BX-B 
Intel 28F200BX-T 
Intel 28F200 BX-B 
Intel 28F004 BX-T 
Intel 28F004 BX-B 
Intel 28F400BX-T 
Intel- 28F400 BX-B 
SST29EE010/29LE010 
SST29EE020 
SST29EE512 
SST28SF040 
ST M28F101 
MX28F1000 
MX28F2000 
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3.0 PLATFORM.DLL Detail 

flash deteYn^^ ^ Md , "~ ^ 10 ~ a 

3.1 Flit Format 

3.2 File Header Format 

The PLATFORM.DLL file will have the format described below: 
// Global Variable Declarations 



DWORD 
BYTE 
BYTE 
DWORD 
OWORD 
DWORD 
DWORD 
BYTE 
char 
char 
DWORD 
BYTE 



// 
// 
// 
// 
// 
// 
// 
// 
// 



dwFileSixe 
bMenufaetID 
bPartID 
dwFlags 
dwimaoeBuf 
dwMfgXDAddr 
dwPartlDAddr 
bftetryCount 
«zv«rslonU 
atROMFileNameU // 
dwDLLFuncDefine // 
bblockTableSize // 
BLOCK_DESCRIPTOR bloekTable 
BYTE bpartTypesSixe // 
DEVI CET ABLE partTypes U 

dwFileSke 
bM&nufactO 
bPartID 
dwFlags 



ROM image file ai z * 
Manufacturer of flash device 
Part ZD of flash device 
Option flags 

Linear address of image buffer 

Linear address of »fg ZD 

Linear address of part ZD 

Count for /Rn option (default - 0) 

PLATFORM.DLL version 

Name of BIOS image file 

Indicates what functions are defined 

number of blocks in blockTable 

U 

number of flash parts to add 



Number of bytes in the BIOS.ROM file. 
Manufacturer ID 
Part ID 

Option flags. Must be combination of the following values: 

FLAG AUTOSENSEOFF Don't read ID from the part 
FLAG BACKUP Backup system BIOS ROM 

& A &I^SSS!£ Y P. 00 ' 1 fl «h if 64k »t F000:0 same 
FLAGJ>RODUCnON Max speed (sound & video of!) 
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dwImageBuf 



dwMfglDAddr 
dwPartlDAddr 



bRetryCount 

tzVersion 

szROMFileName 

dwDLLTun eO i n« 



hblockTableBis 

dwBlockTable 

bpar t Types 6 is • 
dwPartTypes 



FLAG SILENT 

FLAGJVERIFY 

FLAG_PLATFORMCMD 

FLAG_BIOSPARTNUM 

FLAG_CHECKSUM 

FLAG CMOS 

FLAG~IMAGESIZE 



Do not generate any sounds 

Verify each block after flash 

PLATFORM option str present 

Flash only same BIOS part number 

Checksum BIOS.ROM 

Clear CMOS checksum 

Verily image size matches flash part 



Address for BIOS.ROM image buffer in extended memory. This 
field determines the linear address of a buffer where the image will 
be read into. * 

This area is also used when the SAVE option is specified Any 
blocks to be saved will be using the address range starting at the 
address dwImageBuffer + dwFileSize. 



These two optional fields contain the linear addresses for the flash 
memory ID bytes. When these fields are zero, the default 
addresses of EOOOOh and EOOOlh will be used. 

Number of times to retry if flashing fails. 

Version ofPLATFORM.DLL 

Reserved must be the string "BIOS.ROM". This field is used to 
identify and verify format of the PLATFORM.DLL file. 

Indicates what platform-specific functions are defined in 
PLATFORM.DLL 



• number of blocks described in blockTable 

Flash parts are programmed one contiguous block at a time. Each 
block to be programmed must have a corresponding block 
descriptor. 

number of flash parts to add 

Optional table of supported flash parts. Each entry in the table has 
the following format: 

typedef struct 

( 

BYTE cMfgID; // Manufacturer ID 

BYTE cPartXD; // Part ZD 

WORD wPlaahType; // Flash algorithm type 

char ssPartNaBe[28] ; // Optional description 
) DEVI CITABLE; 

The device table is terminated by a descriptor with cMfgID, 
cPartID and wFlashType set to zero. 
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procEnable 

procOisable 

procBegin 

procEod 

procGetBlock 

procCmdLine 

procSense 

procIsFlashable 

procReboot 

procChcckSum 



Many platforms allow the same BIOS.ROM image to be used with 
several different flash pans. This table is used when a new pan 
becomes available, the part is not among -the pans currently 
supported by PHLASHNT.EXE and the part uses the same 
flashing algorithms as one of the supported parts. 

enable flashing proc 
disable flashing proc 
begin flashing proc 
end flashing proc 

get next BIOS block for backup proc 
process custom command line options proc 
custom autosense proc 

custom OEM proc to determine if ok to proceed 
custom reboot proc 

custom checksum proc to be used if the BIOS ROM image 
checksum is not zero 



A sample source code for PLATFORM JDLL file is shown in Appendix B3. 



3.3 Block Table Format 

Block table consists of a list of block descriptors. Each block descriptor in the block 
table is defined by the following structure: 



typedef struct 

{ 



DWORD dwBlockSixe; 
CHORD dvrileOffaet; 
DWORD dwLinear Address; 
BYTE cMfgID; 
BYTE cPartIO; 
WORD wBlocKAttr; 
) BLOCK DESCRIPTOR; 



// Number of bytas in the block 

// Offset within BIOS .ROM file 

// Linear 32-bit address of flash ROM 

// Manufacturer ID or xero 

// Part ID or xero 

// Block attributes 



The block table is terminated by a descriptor with all entries set to zero. 



dwBlockSize 
dwFileOfTset 

dwLinearAddress 
cMfgID 

cPartID 
wBIockAttr 



Block Size in bytes. Blocks must be contiguous. 

Offset of this block within the BIOS.ROM file. 

Starting address of this block in 32-bit address space 

Manufacturer ID or zero to auto-sense. 

Part ID or zero to auto-sense. 

Determines actions to be taken for this block. 

combination of the following flags: 



Must be a 



ATTR ZERO 

ATTR'ERASE 

ATTR~SAVE 

ATTR~PROG 

ATTR~R£STORE 



Block must be zeroed before programming 
Block must be erased before programming 
Save content of this block before prog. 
Program this block 

Restore content of this block after prog. 
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nonzero, the current block is not p^Sld. Beg,nFlash 0 

bYuseJ f0rt anothcr ATTR.SAVE bloik can 

W^k^IwJJ^T flMh ™i* there may be several 

Eta? fiSPWtffl^ t0 K F«crve a 1ft flash memo* 

bcS blS! Pr0gram Wk » d third to reswV5£ 

Se ATTR ^^St* f* fl 5^ ng ' il is ^nimended that 
,JL£y?- P H V 0 . 1 ." 5 ^ this will avoid the 

zeroinft step and cut ue flashing time in half. Only few of XI 

m T°S typcS «8E«led that part is zeroed before h£ 
re-programmed. Most parts do not require this operation 



3.3.3 Multiple Flash Blocks 



lengths for each bloc* ofia^> be flashed 000141,1 propcr off$ets and 

To ,? ro R e iy wafigure the platform before and after each flash block. PHLashnt pvp 
will call function BeginFlash(Block Index) to allow in^^SS^^ ZT ^' EXE 

3.3.4 Processing Boot Blocks and ESCO storage 

W«fv°JfI!? l a . mem ? ry l*" 8 * to ** flash memor * there' may have to be several different 

b ock SlSSSZ^Jt^ mCm0iy 1,118 * to j£*n*b5 

oiock or ESCD storage within a single 'erase' memory range. 

btck ^ f^^An??f I, v nUmbcr ° f L write one for each memory 

oiocK. For example Intel 28F400 flash memory has seven blocks tone 16k boot block 

can be erased with only seven write operations. 
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SSk?"!? rCqu L re • ■AfoiM"! Platfonn dependent actions need to be taken w rtf , . 
boot block cm be programmed. For example Intel parts requSTili VHH vaiul. • 

3.3.5 Block Table Examples 

SA^0W4.CPp f0U0WiDg CXamplM * 0uM te Placed 1,1 "WockTiMe" section of 
Erase a 4KB block at FC000. 

»0 4 * 1024 . , 4U 

00 OOOKOOOh , U n.« ftddr.M »( tu, Wock 

* ^ ; <ut * ttit) 

Zero, then program a 128KB blockat E0O0O on the speci5ed part, 
eo oooeooooh , a,.., ld < rtM ef ^ M 

S fl? ' «« ID (0 - dcUultl 

OH „ M ' »•« XO (0 • 4«t»ult> 

OW ATTR.ZERO Oft ATTft.PKOO ; Actios flags 

3.4 PLATFORM.DLL Functions 

Currently supported functions are: 

EnableFlish t0 m P ltmtnl platform-dependent functionality: 

DisableFlash 

BeginFlash 

EndFlash 

GetBlock 

CmdLine 

AutoSense 

IsFlashablc 

Reboot 

Checksum 
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PhoenixPHLElff. ffath ROM Pr ogramming Utility forffindow* NT D-lgn Sp>clflcatlon 

tht ' following functions allow PHLASHhfT.EXE to access global variables 

ond data structures contained in PLATFORM DLL' ■ 

GetBIOSFileSize 

GetManufactID 

GetPartID 

GetFlags 

GetlmageBuf 

GetMfglDAddr 

GctPartlDAddr 

GctRetryCount 

GetblockTableSize 

GctpartTypcsSize 

GctBlockTablc 

GetpaitTypes 

GetDLLVersion 

GetROMFileName 

GetDLLFuncDefine 



3.4.1 Function EnableF!ash() 

Entry: None * ' • 

Returns: Error code (or 2ero) 

pis function must be present in the PLATFORMDLL. It is called before any attempt to 
access the flash memory. Actions typically performed by this function include: 

Map flash device into memory 

Disable Cache, Shadowing and Power management 

Flush Cache 

Disable PCI bridge 

Enable ROM for write (VPP on) 

Most platforms require that a jumper is changed before the part can be enabled for 
flashing. EnableFlashO procedure must verify that this jumper has been removed and 
return an error code if it was determined that jumper settings are incorrect. See Appendix 
B for error codes. 

3.4.2 Function DieableFlaihO 

Entry: None 

Returns: Error code (or zero) 

This optional function is called after the last block has been programmed (or error was 
defected). It will be called immediately before PHLASHNT.EXE exits (typically as a last 
call before re-boot). It should perform all functions necessary to be able to cleanlv re- 
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Action typically performed by this function include: 
Disable ROM Write (VPP ofi) 

3.4.3 Function Beg!nFIaah(DWORD Block Jnd«x) 

Entry: Index of the block about to be programmed (or zero if table not used) 

Exit: None 

Returns: Error code (or zero) 

This optional function is called by PHLASHNT.EXE immediately before the flash block 
is processed. It will be called for each block (found in the block table). 

Actions typically performed by this function include: 

Save BOOT block before it is erased 

Switch from one device to another (on platforms with multiple devices) 
Enable VHH for boot block re-program 
Determine if the current block should be processed 

If BcginFlashQ returns nonzero, the current block will not be processed. 

3.4.4 Function EndFlaah(DWORD Block Jndex) 

Entry: Index of the block just programmed (or zero of table not used) 

Returns: Error code (or zero) 

This optional function is called by PHLASHNT.EXE immediately after the flash block 
was processed* It will be called for each block (found in the block table). 

Actions typically performed by this function include: 

Restore BOOT block saved by BeginFlashQ function 
Clean-up between programming two different devices 
Disable VHH if boot block was just programmed 

3.4.5 Function GetBIock(bWORD Index. DWORD BufTer_Address) 

Entry: Index of the block to be copied and linear address of a 64k buffer 

Exit: Buffer is filled with the next block of existing BIOS ROM image 

Returns: Negative error code, zero, or positive block index 
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This optional function is called by PHLASHNT.EXE whenever the /BACKUP flag is 
specified. OetBlockO is used to assist when saving the existing content of the flash 
memory before the flash memory is changed. Because many BIOS images are de- 
compressed into shadow RAM, it is not always possible for PHLASHNT.EXE to access 
all of the BIOS ROM image without platform dependent system setup. Function 
GetBlockO is necessary to allow for platform dependent accessing of the existing BIOS 
ROM image. BIOS ROM image is saved by PHLASHNT.EXE using the following 
steps: 

1) Call GetBlockflndex, Buffer) with Index set to 0 and the 64k buffer, pointed to 
by the parameter Buffer, filled with a pre-defined pattern. If the pattern in the 
buffer is not changed, program exits with error. If the pattern is changed, then the 
buffer is saved as the first 64k block in the B10S.BAK file, then program proceed 
to next step. 

2) Call GetBloekOndex, Buffer) with Index set to the value returned by the 
previous call to GetBlockO. save the 64k buffer into BIOS.BAK and repeat this 
until the value returned by GetBlockO is a non-positive number. 

3) If the last value returned by GetBlockO is 2ero, then proceed with flashing of 
the memory. If the last value returned is negative error code, report the error, 
delete BIOS3AK and exit 

It is the responsibility of the GetBlockO implementation to ensure that the platform is in a 
proper state to allow the GetBlockO to copy BIOS ROM image into the buffer and that 
the platform is restored to the original mode before GetBlockO returns control to 
PHLASHNT.EXE. In particular, GetBlockO is called before a call is made to 
EnableFlashO- The buffer pointer passed to GetBlockO is always in the real memory 
range below 640k, to allow direct transfer to disk. 



3.4.6 Function CmdLlne(char far *azOptiona) 

Entry: Pointer to a string with the platform specific command line options 

Returns: Error code (or zero) 

This optional function is called by PHLASHNT.EXE immediately after the 
PLATFORM.DLL was read in. It is passed the address of the string containing all the 
platform specific command line parameters (specified after the equal sign with 
/PLATFORM 3 "..." command line option). The string includes the leading and trailing 
double quotes, if any. 



3.4.7 Function AutoSenseO 

Entry: Manufacturer and device IDs retrieved from PLATFORM.INI header 

Returns : New ID retrieved from the flash part (or zero) 
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This function is called by PHLASHNT.EXE immediately after EnableFlashO function in 
the PLATFORM.DLL was called. The AutoSenseO function enables auto detection of 
memory flash parts when "non-standard" memory organization is used for the flash 
memory. For example when two separate parts are used for even and odd BIOS 
addresses (in which case the conventional auto detect mechanism will fail), this function 
can be used to obtain and verify ID for each of the parts. 

IDs are one byte long and are packed into a DWORD, with manufacturer ID in BYTE 0 
and device ID in BYTE 1. 



3.4.8 Function lsFlashable(char far 'szErrortttg) 

Entry: Pointer to string to contain returned error message. 

Exit: izErrorMsg containing error message string. 

Returns: Error code (or zero) 

This optional function is called before EnableFlashQ to determine if it is ok to proceed. 
If the function returns a nonzero error code, the string izErrorMsg is displayed and the 
program terminates. Up to 254 bytes plus a terminating NULL may be returned in 
szErrorMsg. 

An example of how this might be used is: for the same platform, an OEM sells a system 
with and without Plug and Play capabilities. The IsFlashableO function can determine if 
the system currently has Plug and Play and will not flash a Plug and Play BIOS on a 
platform that doesn't already have it 



3.4.9 Function RebootQ 

Entry: None. 
Returns: None. 

This optional function is called after programming is complete to reset the system. If 
provided, this is called instead of PHLASHNTs own reboot code. 



3.4.10 Function CheckSum() 

Entry: None. 

Returns: Error code (or zero) 

This optional function is called before programming to determine if the checksum of the 
BIOS ROM image is correct. Normally, the BIOS ROM image checksum for a NuBIOS 
image is zero. This routine may be used to provide an alternative checksum verification 
method when it is known that the ROM image checksum will not be zero. If this function 
returns non-zero, PHLASHNT will terminate. 



3.4.11 Function GatBIOSFileSlze-0 

Entry: None. 

Returns: Size of BIOS image 
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This function returns the contents of the global variable jiwFileSize from 
PLATFORM.DLL. 



3.4.12 Function GetManufactlD() 

Entry: None. 
Returns: Manufacturer ID 

This function returns the contents of the global variable bManufactID from 
PLATFORM.DLL. 



3.4.13 Function GetPartJDQ 

Entry: None. 
Returns: Pan ID 

This function returns the contents of the global variable bPartID from PLATFORM.DLL. 



3.4.14 Function GetFlagsO 

Entry: None. 
Returns: option flags 

This function returns the contents of the global variable dwFlags from 
PLATFORM.DLL. 



3.4.15 Function GetlmageBufQ 

Entry: None. 

Returns: Location of Image BufSer 

This function returns the contents of the global variable dwImageBuf from 
PLATFORM.DLL. 



3.4.16 Function GetMfglDAddrO 

Entry: None. 

Returns: Address where Manufacturer ID is located 

This function returns the contents of the global variable dwMfglDAddr from 
PLATFORM.DLL. 
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3.4.17 Function GetPartiDAddrQ - 
Entry: None. 

Returns: Address where Part ID is located 

» 

This function returns the contents of the global variable dwPartlDAddr from 
PLATFORM.DLL. 



3.4.18 Function GatRetryCountO 

Entry: None. 

Returns: Number of times to retry flashing if failure occurs 

This function returns the contents of the global variable bRetryCount from 
PLATFORM.DLL. 



3.4.19 Function GetblockTableSize() 

Entry: None. 

Returns: Number of blocks in blockTable 

This function returns the contents of the global variable bblockTableSize from 
PLATFORM J)LL. 



3.4.20 Function GetpartTypesSiztO 
Entry: None. 

Returns: Number of additional flash parts that PLATFORM.DLL will describe 

pus function returns the contents of the global variable bpartTypesSize from 
PLATFORM.DLL. v 



3.4.21 Function GatBlockTabla() 

Entry: None. 

Returns: address of blockTable 

This function returns the address of the global structure blockTable from 
PLATFORMDLL. 
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3.4.22 Function GetpartTypaaO 

Entry: None. - 

Returns: address of partTypes 

This function returns die address of the global structure partTypes from 
PLATFORM J5LL. ¥ 



3.4.23 Function GetDLLVersIonO 
Entry: None. 

Returns: Version of PLATFORMDLL 

This function returns the contents of the global variable aversion from 
PLATFORM.DLL. 



3.4.24 Function GetROMFHaNamafj 

Entry: None. 

Returns: Name of BIOS ROM file 

This function returns the contents of the global variable szROMFiieName from 
PLATFORM.DLL. 



3.4.25 Function GetOLLFuncDaflnaO 
Entry: None. 

Returns: Indicates what platform-dependent functions are defined 
in PLATFORMDLL 

This function returns the contents of the global variable dwDLLFuncDefine from 
PLATFORM.DLL. 
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4.0 BIOS.ROM Detail 

f^L^^itf 1 V** mUS ? ^ ^ e Cnou ^ t0 Wocki in the flash devicef $) 

to be programmed Any required post-processuic of the BIOS imase such a< iv^t xiIA 
swapp.ng or data compression, musTb/ilready in\or,!oS 
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5.0 General Implementation Guidelines 

Programs will be developed using Microsoft Visual C++, V42 or later? 

Because it is expected that this program will evolve as new devices become available and 
because code »ze ts not cnticaf, the style of coding should be such ihiYeLk "readability 
and clanty should have higher priority than executable code compactness rMdaW,| y 

However, because the program may also be used in production environments It should be 
structured as to allow shortest possible time for partYlashing. In particular, it shou! I have 
a mode where non^ntical user interface notifications c£ be disabled; and ^whenever 
oossjble, time consuming flashing functions should be written in optimized ranty 
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Appendix B1 -Future enhancements 
Completion Codes with Keyboard LEDs 

keyboard w,fl be turned on. The failure at elch ci^S^J^liSi^ 
tS&SH ,)eSCr,|,d0,l 

r^l'lS^ ,SCR0LL Before reading platform-dil 

CAPS.NUM Before platfwminit 

NUM After platform bit 

none Successful completion 
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Appendix B2-PHLASHNT.H Completion and error codes 

FCh Fi e Wntc failed on BIOS.BAK 

St Sfef! 0 * 8 Med on B10S3AK 

FQh f/unhf^ n f t ^P 0 ^ » PLATFORM DLL 

K? 5 e ?P« railed on PLATFORMDLL 

2? £• e Read failed on PLATFORMDLL 

F7h File Close foiled on PLATFORMDLL 

tbh Failed to locate signature bytes in PLATFORMDLL 

F5h Unsupported PLATFORMDLL ffleversiod i 

F2J Device Mc ^ PLATFORMDLL has too manv entries 

Int 2^* ble kM^FORMDLLh«u^^^ 

EFh Coined SAVE or RESTORE mtibmSSSS^uSRjL 

g * PLATFORMDLL 

|ft Open failed on BIOS ROM image file 

Uk ^^<«! I0S ROM toaje file 

fj" File Close failed on BIOSJIOM 

12? A^pt to read flash memory ID failed 

S ?^F°^?ii^^tum flash memory ID 

E?h SfeES" ^ BC ? S XS block in BIOS ROM fUe image 

lit K i 001 contam ^e BIOS part number 

hpk rSt " not ^nion of BIOS ROM image 

df5 8ft ^y n i!° fla3h doe$ not match WOS ROM Sage 

ggh Wnte to flash memory failed ■ 8 

22? ™e flash memory block fciled 

DCh VPP is not at expected level 

DBh Erase sequence failed 

DAh New DMI string is too large 

SfS I?f B iP s ROM file ma^ not be used whh this system 

D8h Alloc for DMI OEM string failed 

S*B^^* ec ^ DM ^^»*e BIOS ROM 
DM^ OEM stnngs not supported (BCPDMI 0.1+ required) 

mS SKSKAS BCPDMI W «* ^ BIOS ROM file image 

t8£ 5 KM fie may be commt (checksum not zero) * 

R?£ BIOS ROM file size doesn't match flash part size 

i-»in UMI system and chassis strings require BCPDMI 2.1+ 
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Appendix B3-PLATFORM.DLL Sample source code 



PLATFORM.CPP 

« 

• TXTU rUTrOMJ.CFf - 3J.| it oil to prorid* pl.t for* d.ptndtct tuneUorulitv 

* to rHLumrr.zxc * y 

* SXEWJSi } M ? by . ^°« Bi * T«eh«*lo«i.», All Ugfat. tU..rr,d. 

• H»o«rvi» T«ehnolo«lM Ud. CWMBtMTIAfc. 



♦ ttltnaat; rLATfOW.Cfr 

• Project! PMLA5HNT • DCS 
* 

* functional ElocXc 



* Cement*: Tbe variable dwDLLruncDefiae la msed la PKLMKKT to determine 

**** pUtfora epeciflc fuactioea ia FlAtroWi.OU, have been 

* defined. Ueted below are the poeslblo value • of 

* es#DUJW£*fine and what function, they indicate ere defined 

* in tble nodule: 
* 

* m^tNULiruan c&abiettaab 

* »t_DISA»LtnASK ftiaebierieah 

* Dix.ico:iinjk3H fteginttath 

* du_gethocx oetBlock 

* DU,_GM0L2tf£ CxULlne 

* DLLAOTOSWSt AutoSense 

DLL_ISF1ASHABLI UTUihe^le 



DlL_RJt»O0T Reboot 
DU.CKKX5QM Checfcium 



Contents: 



• version Control Information; 



• SLog: *s/»/*rchlv«/n«tool»/phIa»h.nt/et»9«2/4rlv*r*/platfor».cpv I 



Mf 1.0 
Initial revision. 



♦include *stdarjuh a 
♦include <afxdlix.h> 

♦include <etdio.h> 

I include -0 ; \HUTOOL3 \PHLASB . KT \STACt2 \phla Shn t . h" 
♦define PlATfORM^CPP 



// global variable Declarations 

WOW dvttleSiie m 0x000400001 // ItOM iaage tilt elxe 

■YTC bHanufactXD - 0x09; // Hanufeccuter of flash device 

■rrt bPartib - 0*mo/ // part id of fiaeb device 

* ^ ^ '/ Option flee* 

DWORD dwUeos- PLAC_B1 OS PARTHUM I nAC_C*XCKSUH I F1AC tWAGtSIBE/ 

DWORD dwXaegeBuf - 0x00200000/ // Linear ad drees of Usage buffer 

WORD dwttfalbAMr - OxTtrtoooO; // Linear address of afg to 
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DWORD 

mi 

char 

ctur 



dvftrtinMdr - Oxirrtoooi, // LiaoAr sddrsss of osrt id 
iiMHrUiMiMl] - -HM.iOf; // Msm of AXOS uI»"uo 



nuAnrs -i ~ N Xft ^lc4tii vhst functions srs dofinod i n tLstmoji nrr 
WORD dwDU-runcDtfin* • DLL tKARUTLXAK r 1AT rORM . DLL 



DLL KKXAUTUJK 
DLt"DItABLtn-UH 
DLL'iXOXKTLASH 
DLL*Or01TAiB 

DLt"orr»uxx 
eu~ooLX*t 

DLLJUTTOAEMJt 

ou.zsrusKUXx 

DLL REBOOT 

DLlTcucutM ; 



1024, 



( 

128 

o, 

oxirrtoooo, 

ATTR ItRO 

I # 



BYTE bblockTsbissito 
BLOCK^DEBCRIPTOR blockTAblt (] - 



// do f Ida blockTsblo 

// 



5; 



// number of blocks in blockrsbl* 



// 121)3 (Lev) 
// rilo offsot 

// LiAosr AddrASs of flash ROM 
// KfgXD Uiai as dofsult) 
// tartXD (aam ab dofsult) 



( 

121 • 1024, 
0x00020000, 

oxrnroooo, 

0, 
0, 



// 12tft§ <liob) 

// riio offsot 

// Lintar Addroas of msh ROM 
// MffXD (|4M AS As f Suit) 
// »ArtXD (SAM as dofsult) 



1024, 



< 

121 

0, 

oxirrxoooo, 

o, 

o v 

ATTR OUAt 



// 12IU (Low) 
// filo offsot 

// LiAAAr sddrsss Of flASA BOM 
// HfQlO <SSAS AS dAfAttlt) 

// »artXD (SAM as dofsult) 



( 

121 ' 1024, 
0, 

OxITCOOOO, 

0s 

0. 

< 

121 • 1024, 

0x00020000, 

oxrrrtoooo, 

o, 

o, 

ATTR FROG 
>, " 

I 

0, 
0, 
0, 

o, 
o. 



// 12BU (tow) 
// rilo offsot 

// Linssr sddrsss of flssb ROM 
// MfgID (saim as dofsult) 
// PsrtlD (ssm ss dofsult) 



// 12SKB (Rich) 
// rilo offsot 

// Linosr sddrsss of flash ROM 

// MffllO (SABA AS dOfAult) 

// Bsrtlt (sam as dofsult) 



// Mood to tormlosto blockTabl* Mich 
// a block sot to 0. 
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); 



•fTC bperttypeaSise - \> 
DCVICtTXJLt partTyp«a() - 



< 

0x89, 
OxBD, 

1. 

), 

i 

o, 

0. 
0, 
0* 



// mm 

it define pa retype • 

// * 



// D«b<r of flesh parts on pletfora 
// Set to 0 if partTypes is not usedt 



// Manufacturer 10 of flash device 
// Device to of flash device 
// flashing algorithm typo 
// XGXOM wPertSlte 
// aaae of flash device 



// Heed to terminate partTypes with 
// a block aot to 0* 



HIWSTANCt h*srnel32 -0; // ROW: Do HOT Changs this lias of code. 



functions 



• function Mane : DllHain 

» ■ 

* Description: 

* Parameters: 

• He turns: 



notes ! 



DO ROT UQOlfT THIS rWCTIOM 



extern "C" int APXOfTRr 

DllMain (HINSTANCZ hln* tenet. D*ORD dvReeaon, LfVOXD lpResereed) 



if (dvReason — DLL_PROC£SS_amCH) 



TKACC0 ("fLATfORM.DLL D«ginl\n*); 

hKernel32 - LoadLibraryt -MrnelJ2.Dll* ); // Get Handle to K*»el32.Dll 



else if (dwReasoo ** DLL PROCESS DtTACH) 

C 

TRACC0< "PIATfORM.DLL Terminating I \fi") ; 
if <hRernel32> 

freeLibraryl hKernel32 )/ 



) 

return 1; 
) // DllMtlnO 



// ok 



/••••••••••• 

♦ functioo W 



Cnebleflash 



• Description: 

• Parameters t 
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Pho«nbtPHL>W FUeh ROM Programming Utility torWndowt NT Dwipn Sp#cmcttior 

♦ Mturni: 

♦ notta: 

m — * 

DU._IUNC_TYTE void tAAblerissh { > * / 

( 

prl&tt(*£fl4bl«rl*4hVn a )f // (stub) 

■/ 

• function Kami DlAAblettAsh 
• 

* Description! 

* Pir4A«t«rii 

* Mturnss 
« 

• Notes: 

oiA_n)NC_rYP£ void oi»«bi«ri4aho " **" 1 

printf (-0ii4bX«riaah\n a )i // (stub) 

I 

/ • 

* 

• rune t ion nam: nefinriesh 

* Description: 

* Mturas: 
« 

• Mot**: 

W-_rovCjrt*l short »egintt*sh( WHOM blockMuaber ) ' 

i 

return Oi // (stub) 

) 

* 

• IMnctlon nam: sndttAAb 
• 

• Description: 

* PArAMters: 

* Returns: 

* Motet : 

W.t_rwC_TT»T short C&4ttAs&( QSHORT biocDhmber ) ' 

( 

return 0; // (stub) 

) 

• • 

• 

• function Nam: Gets lock 



• Description; 

• PAZAMttrs: 
'\ 9 ftoturnst 

• Botes; 

tM«t l tMttttffM V t«tlfffll..M VV ,M tM9V M«Mllff»t«t«f«ttltM«tltHMtlM/ 

Dli TUNC TYTZ SHORT Getftlockt VLOWG dwlnds*, TUVOM dwOst ) 

( 
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) 

/•••••••••••• •• , ... ■- 

* function Viae: OedLint 



• 

♦ Description: 

* vertftettrt: 

• Mturni: 
• 

* Kotes: 



DU,_ruiac_TTFI MXQ*T CtedUae ( char •flatfoaStrlaf 



printf CCBdUntVft*); // (stub) 
return ( 0); // dtub) 

) 

• 

• runctlofl Vm: AutoSen»e 

• Deecription: 

• Mturnii 

• lletee: 

• Tht »*mifeeturer XD it in im 0 tad Uric* ID in 1YT£ l 



DLL_rwCjmt 0*0» lutoisneeC CMC** PartMigXD ) 
return* 0x0000 ); // ($tub) 

) 

/ ••• • * 

* •••••••• »• 

• runctioa Ram* XsrieaaabXe 

• Description: 

* P«ruutixi: 

• Returns: 

♦ Potee: 

DLL_rTOC_TYPF. OSHOftt XmeeoableC) •••••••••• ♦ •/ 

print* c a 2oriashablo\a a >#. // <etub> 
return 0; 

) 

/••••••»••••• ♦ ## #### 

♦ IMnctloo Mum: lUboot 

• Description: 

* Parameters: 

* Returns: 
« 

♦ notes: 

DLL_rTOC_TY»t void Reboot () * * * ••••••/ 

print* t -Reboot \n*)# // (stub) 

> 

/••••.••••••••,*,„ 



C 2 € C 3 . PCC 2 
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• IMnctiaft Nan CheekSua 
• 

• Description! 

• Return*: 

• Mote*: 

DLL_rWC_TYPE void ChKUUMO 

printf CCheckiueAn*)/ // (*tub) 



if — — 

oll nmc 
ouTro^c" 

OLL"fUNC" 

ouTrwc* 
DLzTrwc' 

DUTrONC" 
DUTrUWC" 
DLL~rUNC* 
OLL~fWC" 
0Lt""n3KC* 
DLL~n?HC" 
OLL~FVNC' 
OLL"rONC* 
DU*FVNC" 



WOTEi DO HOT W>Orrt TKt FUWCTIOM LUTED BELOW. 



.TYPE 
TYPE 
TYPE 
>YPE 
TYPE 
TYPE 
TYPE 

type 

TYPE 
TYPE 
TYPE 
TYPE 
TYPE 
TYPE 
TYPE 



WORD 

»m 

irrt 

DWORD 
DWORD 
DWORD 
DWORD 
BYTE 
BYTE 
BYTE 

BLOCK DESCRIPTOR 
DEVXCETA1LE 



CetBXOSrlleSise (veld) 
CetMenuf eetXD (void) 
OetPartXD(vold) 
Cetriigetvoid) 
GetXa*9eBut(void) 
GetMfffXDAddrfvold) 
©•tPartJCAddt(void) 
GetRetryCnunt (void) 
GetbloekTeblef it* (void) 
GetpercTypesSite (void) 

•©♦tBlocmble(veid) 
•CetpartTypet (void) 



( return (dvlXleilse); ) 



char •GetDLLVer»ioo<v©ld) ( 
char •Get*CMrUeH*tte(void) ( 
DWORD G«tDLLruncDt fine (void) ( 



return (btunutectXD)) ) 
retuxn(bPartXD); > 
return (dvTlage > * ) 
return (dvXaueeBur); ) 
return (d*ft*XDRadr); ) 
return (dwpartXDAddr); ) 
return (bRetxyCount) / ) 
returnfbblockTebleSlse) j ) 
rtturn(bpertTypee$lre); ) 
( retum(iblockT*blttO)); ) 
( return UptrtTypet 1 0)); ) 
" ) 



return (rsVereion) 
return (ecRCNrileMeae); ) 
return (dwrnxruncoe fine); ) 



